home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 2).iso / 1156 / casformt.txt < prev    next >
Text File  |  1997-04-17  |  8KB  |  251 lines
  1. This note describes the format of a CaseLinr 4.8 liner file.  For versions
  2. prior to 4.8, Open and Save the file and it will be converted to this format.
  3. All uppercase types are defined below. All lowercase types are "standard C"
  4. types as they exist within the 16-bit DOS world.
  5.  
  6. Type        Description
  7. --------    -----------
  8. int         Major version number - this release would have a value of 4
  9. int         Minor version number - this release would have a value of 8
  10.  
  11. short       Number of title lines - if 0 then the next two fields do NOT exist
  12. UINT        Total byte length of title lines including null
  13. char[]      Title lines - null terminated fonted text string, intermediate
  14.             lines are separated by CR LF (x'0D' x'0A')
  15.  
  16. short       Number of side A song lines - if 0 then the next two fields do
  17.             NOT exist
  18. UINT        Total byte length of side A song lines including null
  19. char[]      Side A song lines - null terminated fonted text string,
  20.             intermediate lines are separated by CR LF (x'0D' x'0A')
  21.  
  22. short       Number of side B song lines - if 0 then the next two fields do
  23.             NOT exist
  24. UINT        Total byte length of side B song lines including null
  25. char[]      Side B song lines - null terminated fonted text string,
  26.             intermediate lines are separated by CR LF (x'0D' x'0A')
  27.  
  28. SONG_FMT    Format of title
  29.  
  30. BYTE        Split title indicator:
  31.                0 - don't split
  32.                1 - split
  33.  
  34. BYTE        Center title vertically within title area indicator:
  35.                0 - don't center
  36.                1 - center
  37.  
  38. SONG_FMT    Format of songs in Side A primary area
  39.  
  40. SONG_FMT    Format of songs in Side B primary area
  41.  
  42. SONG_FMT    Format of songs in Side A overflow area
  43.  
  44. SONG_FMT    Format of songs in Side B overflow area
  45.  
  46. int         Pen style used for border (cut) lines:
  47.                0 - solid
  48.                1 - dash
  49.                2 - dot
  50.                3 - dash-dot
  51.                4 - dash-dot-dot
  52.                5 - (none)
  53.                6 - (endpoints)
  54.  
  55. int         Pen style used for interior (fold) lines, same values as border
  56.             lines
  57.  
  58. BYTE        Invert liner indicator:
  59.                0 - don't invert
  60.                1 - invert
  61.  
  62. BYTE        1-up sides indicator:
  63.                0 - not 1-up (i.e. "normal" 2-up side-by-side)
  64.                1 - 1-up
  65.  
  66. BYTE        Bisect sides indicator:
  67.                0 - don't bisect
  68.                1 - bisect
  69.  
  70. MEASURE     Liner width
  71.  
  72. MEASURE     Feature flap height
  73.  
  74. MEASURE     Title area height
  75.  
  76. MEASURE     Main song area height
  77.  
  78. MEASURE     Overflow song area height
  79.  
  80. SIDE_FMT    Format of side letter for Side A Flap
  81. UINT        Total byte length of side letter text for Side A Flap including
  82.             null - if 0 then the next field does NOT exist
  83. char[]      Text of side letter for Side A Flap - null terminated fonted text
  84.             string
  85.  
  86. SIDE_FMT    Format of side letter for Side A Primary
  87. UINT        Total byte length of side letter text for Side A Primary including
  88.             null - if 0 then the next field does NOT exist
  89. char[]      Text of side letter for Side A Primary - null terminated fonted
  90.             text string
  91.  
  92. SIDE_FMT    Format of side letter for Side B Flap
  93. UINT        Total byte length of side letter text for Side B Flap including
  94.             null - if 0 then the next field does NOT exist
  95. char[]      Text of side letter for Side B Flap - null terminated fonted text
  96.             string
  97.  
  98. SIDE_FMT    Format of side letter for Side B Primary
  99. UINT        Total byte length of side letter text for Side B Primary including
  100.             null - if 0 then the next field does NOT exist
  101. char[]      Text of side letter for Side B Primary - null terminated fonted
  102.             text string
  103.  
  104. int         Number of fonts used - count of LOGFONT, DWORD pairs. There are
  105.             always at least 5 fonts, and these are reserved as follows:
  106.                0 - default side letter
  107.                1 - default feature name
  108.                2 - default feature
  109.                3 - default title
  110.                4 - default song
  111. LOGFONT     Windows Logical font definition
  112. DWORD       Color of font
  113.  
  114. int         Total number of features - count of FEATUREs that follow the
  115.             "next" field
  116. int         Total number of sided features
  117. FEATURE     Feature definition(s)
  118.  
  119. int         Default measurement type
  120.                1 - centimeter
  121.                2 - inch
  122.                4 - line
  123.                5 - pica
  124.                6 - point
  125.  
  126. UINT        Total byte length of tab stops including null - if 0 then the
  127.             next field does NOT exist
  128. char[]      Text of tab stops - null terminated char string
  129.  
  130. int         Total number of pictures - count of PICTUREs that follow
  131. PICTURE     Picture definition(s)
  132.  
  133. int         Total number of song overflow areas
  134.  
  135.  
  136.  
  137. The type SONG_FMT is composed of the following fields:
  138.  
  139. int         Song alignment
  140.                0 - left
  141.                1 - centered
  142.                2 - right
  143. MEASURE     Song left margin
  144. MEASURE     Song right margin
  145. MEASURE     Song top margin
  146. MEASURE     Song bottom margin
  147. MEASURE     Song wrap margin
  148. MEASURE     Song between spacing
  149. MEASURE     Song within spacing
  150.  
  151.  
  152. The type SIDE_FMT is composed of the following fields:
  153.  
  154. int         Letter style
  155.                0 - normal
  156.                1 - reverse video
  157.                2 - none
  158. MEASURE     Letter top margin
  159. MEASURE     Letter side margin
  160. UINT        Unused
  161.  
  162.  
  163. The type FEATURE is composed of the following fields:
  164.  
  165. UINT        Total byte size of FEATURE structure
  166. UINT        Unused
  167. int         Feature style
  168.                0 - centered with sides
  169.                1 - left justified
  170.                2 - right justified
  171.                3 - centered
  172.                4 - adjacent with sides
  173.                5 - blank with sides
  174. MEASURE     Top margin
  175. MEASURE     Side margin
  176. char[]      Variable number of characters as follows:
  177.                feature text - null terminated fonted text string
  178.                count of side 1 texts - 1 char
  179.                index of selected side 1 text - 1 char
  180.                side 1 text #1 - null terminated fonted text string
  181.                ...
  182.                side 1 text #k - null terminated fonted text string
  183.                ...
  184.                count of side n texts - 1 char
  185.                index of selected side n text - 1 char
  186.                side n text #1 - null terminated fonted text string
  187.                ...
  188.                side n text #m - null terminated fonted text string
  189.                0 - 1 char
  190.  
  191.  
  192. The type PICTURE is composed of the following fields:
  193.  
  194. UINT        Total byte size of PICTURE structure
  195. UINT        Unused
  196. MEASURE     X coordinate
  197. MEASURE     Y coordinate
  198. MEASURE     Width
  199. MEASURE     Height
  200. BYTE        Picture type
  201.                0 - bitmap
  202. char[]      Pathname of picture file - null terminated char string
  203.  
  204.  
  205. The type MEASURE is composed of the following fields:
  206.  
  207. int         Integral portion
  208. int         Decimal portion as an integer
  209. int         Number of decimal places
  210. int         Measurement type
  211.                1 - centimeter
  212.                2 - inch
  213.                4 - line
  214.                5 - pica
  215.                6 - point
  216. int         Numerical value in twips
  217.  
  218.  
  219. The type LOGFONT is a WINDOWS structure composed of the following fields:
  220.  
  221. int         Height
  222. int         Width
  223. int         Escapement
  224. int         Orientation
  225. int         Weight
  226. BYTE        Italic
  227. BYTE        Underline
  228. BYTE        StrikeOut
  229. BYTE        CharSet
  230. BYTE        OutPrecision
  231. BYTE        ClipPrecision
  232. BYTE        Quality
  233. BYTE        PitchAndFamily
  234. char[32]    Face name
  235.  
  236.  
  237. Some basic types:
  238.  
  239. UINT     "unsigned int" and is 2 bytes long
  240. BYTE     "unsigned char" and is 1 byte long
  241. DWORD    "unsigned long" and is 4 bytes long
  242. int      integer and is 2 bytes long
  243. short    short integer and is 2 bytes long
  244. char     1 byte long
  245. char[]   variable length array of bytes
  246. char[x]  a fixed length array of x bytes
  247.  
  248. A null terminated fonted text string is a null terminated char string with
  249. embedded font indicators.  A font indicator is 2 consecutive bytes, the first
  250. has the binary value 1 and the second is the 1-relative font number.
  251.